home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / OS2 / SIDIS098.ZIP / SIDIS.DOC
Encoding:
Text File  |  1996-04-14  |  24.2 KB  |  426 lines
  1. ┌────────────────────────────────────────────────────────────────────────────┐
  2. │                                                                            │
  3. │       SIDIS/2 - Small Internet Dial-In Server Package for OS/2             │
  4. │       *** PUBLIC BETA TEST *** (until 05/30/96)                            │
  5. │       (C) 1996 Axel Mueller                                                │
  6. │       Email:             amueller@stargate.rz.fh-offenburg.de              │
  7. │                          (for questions, suggestions & bug reports )       │
  8. │       Official FTP site: ftp://stargate.rz.fh-offenburg.de/sidis           │
  9. └────────────────────────────────────────────────────────────────────────────┘
  10.  
  11. As you already may guess this software package is designed to give people
  12. access to the LAN or Internet via a LAN connected PC and up to 4
  13. (2 currently tested) modems.
  14. It has grown over the last 1 1/2 years out of the need to provide efficient
  15. and reliable Internet access for students of our campus.
  16. Since the package is in daily use for quite some time at our campus I
  17. don't expect to receive many bug reports. Maybe I am wrong ;-))
  18. Out of my expectations I have set the beta test period only until 05/30/96
  19. after which all programms will refuse to work. At least shortly before this
  20. date there will be a new version which most likely will be Shareware at
  21. very reasonable registration fees.
  22. The SIDIS/2 package contains programms for 2 major areas:
  23.  
  24.     - EMAIL SERVICES (POP3 server, mail processor)
  25.  
  26.     - MODEM SERVICES (modem control, user access control)
  27.  
  28.  
  29.  
  30. ┌────────────────────────────────────────────────────────────────────────────┐
  31. │                                                                            │
  32. │ Content                                                                    │
  33. │                                                                            │
  34. └────────────────────────────────────────────────────────────────────────────┘
  35.  
  36.                    1. Legal stuff
  37.                    2. Features
  38.                    3. System requirements
  39.                    4. Network structure
  40.                    5. Installation of Email Services
  41.                    6. Installation of Modem Services
  42.                    7. Conclusion
  43.  
  44.  
  45. ┌────────────────────────────────────────────────────────────────────────────┐
  46. │                                                                            │
  47. │ 1. Legal stuff                                                             │
  48. │                                                                            │
  49. └────────────────────────────────────────────────────────────────────────────┘
  50.  
  51.        IF YOU DOWNLOAD OR USE THIS PROGRAM YOU AGREE TO THESE TERMS.            
  52.                                                                                 
  53.        Under no circumstances I am liable for any of the following:           
  54.                                                                                 
  55.        1. third-party claims against you for losses or damages;                 
  56.        2. loss of, or damage to, your records or data; or                       
  57.        3. economic consequential damages (including lost profits or             
  58.           savings) or incidental damages                                        
  59.                                                                                 
  60.        I do not warrant uninterrupted or error free operation of the           
  61.        Program. I have no obligation to provide service, defect                
  62.        correction, or any maintenance for the Program. I have no               
  63.        obligation to supply any Program updates or enhancements to you          
  64.        even if such are or later become available.                              
  65.                                                                                 
  66.        THERE ARE NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING THE               
  67.        IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A                  
  68.        PARTICULAR PURPOSE.                                                      
  69.                                                                                 
  70.  
  71.  
  72. ┌────────────────────────────────────────────────────────────────────────────┐
  73. │                                                                            │
  74. │ 2. Features                                                                │
  75. │                                                                            │
  76. └────────────────────────────────────────────────────────────────────────────┘
  77.  
  78. ALL PROGRAMMS
  79.  
  80.    - ONE user database (OS/2 INI-file)
  81.    - Passwords stored encrypted in user database
  82.    - extensive user information stored in user database
  83.    - all programms operate in VIO mode meaning that they can exectuted in
  84.      telnet sessions
  85.  
  86.  
  87. ACCOUNTS.EXE - Manage user accounts
  88.    (Location: C:\USERCTRL)
  89.  
  90.    - There is a syntax help if you start the program without any arguments:
  91.  
  92.      ┌─────────────────────────────────────────────────────────────────────────────────┐
  93.      │ accounts.exe v0.98/Apr 14 1996                                                  │
  94.      │ (C) Axel Mueller (amueller@stargate.rz.fh-offenburg.de)                         │
  95.      │                                                                                 │
  96.      │ Usage:  accounts -a <user> <password> <Real name of user>                       │
  97.      │         accounts -p <user> <password>                                           │
  98.      │         accounts -<f|fc> <user> [forward address]                               │
  99.      │         accounts -<d|r> <user>                                                  │
  100.      │         accounts -m [program]                                                   │
  101.      │         accounts -<l|dm>                                                        │
  102.      │         accounts -s <user> [size]                                               │
  103.      │         accounts -sd [size]                                                     │
  104.      │         accounts -e [size]                                                      │
  105.      │ Flags:                                                                          │
  106.      │ -a    add user and assign password; real name may contain spaces between names  │
  107.      │ -d[p] display user/[programm + mail processor] record                           │
  108.      │ -e    max size of mail for encryption in KB                                     │
  109.      │ -f    forward mails to forward address; ommit forward address to stop           │
  110.      │ -fc   forward copies to forward address; ommit forward address to stop          │
  111.      │ -l    list all user                                                             │
  112.      │ -m    define mail processor  e.g. -m d:\mailproc.cmd                            │
  113.      │ -p    assign password to user                                                   │
  114.      │ -r    remove user                                                               │
  115.      │ -s    max size of mailbox in KB for user; ommit size to remove                  │
  116.      │ -sd   max default size of mailbox in KB for all users; ommit size to remove     │
  117.      └─────────────────────────────────────────────────────────────────────────────────┘
  118.  
  119.    - After some time the user record may look like this ("accounts -d"):
  120.  
  121.      ┌─────────────────────────────────────────────────────────────────────────────────┐
  122.      │ accounts.exe v0.98/Apr 10 1996                                                  │
  123.      │ (C) Axel Mueller (amueller@stargate.rz.fh-offenburg.de)                         │
  124.      │                                                                                 │
  125.      │ *** User record per 14.04.1996 12:52:04 ***                                     │    
  126.      │ GENERAL                                                                         │
  127.      │    User:                      Axel Mueller  (amueller)                          │
  128.      │    Record created:            08.04.1996 22:33:31                               │
  129.      │    Last password change:      08.04.1996 22:33:32                               │
  130.      │ MODEM                                                                           │
  131.      │    First/last login:          09.04.1996 17:10:07 / 14.04.1996 08:58:19         │
  132.      │    Login number/time:         00014               / 000:01:21:04 d/h/m/s        │
  133.      │ MAIL                                                                            │
  134.      │    Max mailbox size:          700 KB (general)                                  │
  135.      │    First/last POP3 check:     09.04.1996 09:49:13 / 13.04.1996 10:40:01         │
  136.      │    Mails received/in mailbox: 00002               / 00000                       │
  137.      │    First/last mail received:  09.04.1996 19:07:10 / 12.04.1996 22:50:42         │
  138.      └─────────────────────────────────────────────────────────────────────────────────┘
  139.  
  140.    - You can also define and display some programm settings ("accounts -dp"):
  141.  
  142.      ┌─────────────────────────────────────────────────────────────────────────────────┐
  143.      │ accounts.exe v0.98/Apr 10 1996                                                  │
  144.      │ (C) Axel Mueller (amueller@stargate.rz.fh-offenburg.de)                         │
  145.      │                                                                                 │
  146.      │ *** Settings for MAIL ***                                                       │
  147.      │ MAIL PROCESSOR                                                                  │
  148.      │    Program:                  c:\userctrl\mailproc.cmd                           │
  149.      │    Record last updated:      09.04.1996 09:44:21                                │
  150.      │    First/last mail received: 09.04.1996 09:45:00 / 11.04.1996 10:56:27          │
  151.      │    Mails received:           00012                                              │
  152.      │ ENCRYPTION                                                                      │
  153.      │    Max mail size:            20 KB                                              │
  154.      │    last updated:             10.04.1996 09:49:23                                │
  155.      └─────────────────────────────────────────────────────────────────────────────────┘
  156.                                                                         
  157.  
  158.                                                                         
  159. MAIL.EXE - sorts incoming mail in user mailboxes (mail directories)
  160.    (Location: C:\TCPIP\BIN)
  161.  
  162.    - stores mails encrypted; a maximum encryption size can be defined to avoid
  163.      system overload
  164.    - mail forwarding; if there is a forward address specified for the receipent
  165.      the incoming mail will be forwared immediately.
  166.      The incoming mail can be kept (COPY FORWARD) or deleted (FORWARD).
  167.    - loop detection for mail forward; each mail forwarded will get a header 
  168.      attached to it for information of the receipent and to prevent a mail loop
  169.    - mail processor; if a mail for a special user ("system") comes in, a programm
  170.      ("mailproc.cmd" - see there) is invoked to process this mail and send out a
  171.      response email immediately
  172.    - Maximum disk space allocated by emails can be defined as default for all users
  173.      or user specific (or both). If a email is coming in which would exceed this
  174.      disk space it will be rejected
  175.    - produces detailed log file in C:\TCPIP\ETC
  176.  
  177.  
  178. POP3D.EXE - POP3 server
  179.    (Location: C:\TCPIP\BIN)
  180.  
  181.    - supports all POP3 commands and extented POP3 commands (except APOP)
  182.    - decrypt mails before transmission
  183.    - supports INET server
  184.    - very robust - no problems with mailbox containing more than 1.000 mails
  185.      or with very large mails
  186.    - produces detailed log file in C:\TCPIP\ETC
  187.  
  188.  
  189.  
  190. MAILPROC.CMD - automatic mail processor
  191.    (Location: C:\USERCTRL)
  192.  
  193.    - implemented as REXX script and therefore highly configurable
  194.    - "help" mail as resonse to mails with incorrect syntax or to help
  195.      requests (see below)
  196.    - users can maintain their passwords and mail forward settings themselves
  197.    - produces detailed log file in C:\TCPIP\ETC
  198.    - already implemented features:
  199.  
  200.         ***********************************************************************
  201.         *               = SYNTAX FOR MAIL PROCESSOR v0.98 =                   *
  202.         * (C) Axel Mueller, 1996 (amueller@stargate.rz.fh-offenburg.de)       *
  203.         *                                                                     *
  204.         * All commands must be given in the SUBJECT!                          *
  205.         * Commands and parameter(s) must be separated by SPACE!               *
  206.         * All commands start with <user> <password> and are followd by        *
  207.         * <command>     and    <parameter(s)>                                 *
  208.         *                                                                     *
  209.         * change_password      <new password>                                 *
  210.         * forward_mail         <forward address>                              *
  211.         * forward_copy         <forward address>                              *
  212.         * stop_forward                                                        *
  213.         *                                                                     *
  214.         * Instead of the commands above you can use the following short cuts: *
  215.         * <command>            <short cut>                                    *
  216.         *                                                                     *
  217.         * change_password      c_p                                            *
  218.         * forward_mail         f_m                                            *
  219.         * forward_copy         f_c                                            *
  220.         * stop_forward         s_f                                            *
  221.         *                                                                     *
  222.         * You will receive a confirmation mail immediately after your         *
  223.         * mail has been received by the mail processor.                       *
  224.         *                                                                     *
  225.         ***********************************************************************
  226.  
  227.  
  228.  
  229. USERCTRL.CMD - modem control/user access control for dial-in users
  230.    (Location: C:\USERCTRL)
  231.  
  232.    - implemented as REXX script and therefore highly configurable
  233.    - this script runs once for each modem connected
  234.    - should work well with 4 modems (2 currently tested)
  235.    - produces detailed log file and connection log file in C:\USERCTRL\LOG
  236.  
  237.  
  238.  
  239. RXPRF.DLL - provides user database access functions from REXX
  240.    (Location: C:\USERCTRL)
  241.  
  242.     - used by mail processor (MAILPROC.CMD)
  243.     - used by modem control script (USERCTRL.CMD)
  244.     
  245.  
  246.  
  247. RXIOCTL.DLL - provides asyncronous I/O functions from REXX
  248.    (Location: C:\USERCTRL)
  249.  
  250.     - used by modem control script (USERCTRL.CMD)
  251.  
  252.  
  253. REG_PRF.CMD  - registers functions RXPRF.DLL
  254.                (Location: C:\USERCTRL)
  255. REG_IO.CMD   - registers functions RXIOCTL.DLL
  256.                (Location: C:\USERCTRL)
  257. REG_UTIL.CMD - registers functions RXUTIL.DLL (comes with OS/2)
  258.                (Location: C:\USERCTRL)
  259.  
  260. UC1.CMD - starts 1st copy of USERCTRL.CMD which serves COM1
  261.                (Location: C:\USERCTRL)
  262. UC2.CMD - starts 2nd copy of USERCTRL.CMD which serves COM2
  263.                (Location: C:\USERCTRL)
  264. UC3.CMD - starts 3rd copy of USERCTRL.CMD which serves COM3
  265.                (Location: C:\USERCTRL)
  266. UC4.CMD - starts 4th copy of USERCTRL.CMD which serves COM4
  267.                (Location: C:\USERCTRL)
  268. PPP1.CFG - PPP configuration file for modem 1
  269.                (Location: C:\TCPIP\ETC)
  270. PPP2.CFG - PPP configuration file for modem 2
  271.                (Location: C:\TCPIP\ETC)
  272. PPP3.CFG - PPP configuration file for modem 3
  273.                (Location: C:\TCPIP\ETC)
  274. PPP4.CFG - PPP configuration file for modem 4
  275.                (Location: C:\TCPIP\ETC)
  276. WELCOME.MSG - login screen sent to modem users after CONNECT before login procedure
  277.                (Location: C:\USERCTRL)
  278.  
  279.  
  280.  
  281. ┌────────────────────────────────────────────────────────────────────────────┐
  282. │                                                                            │
  283. │ 3. System requirements                                                     │
  284. │                                                                            │
  285. └────────────────────────────────────────────────────────────────────────────┘
  286.  
  287.    - Hardware suggestion: 486-DX40 with 16 MB RAM
  288.    - OS/2 Warp + TCP/IP 2.0 + CSD UN64092
  289.    - OS/2 Warp Connect
  290.    - PPP.EXE 2.0 Revision: 1.17  24 Oct 1995 13:57:56  (or newer)
  291.       [ftp://testcase.boulder.ibm.com/ps/fromibm/tcpip/IC12657/IC12657.ZIP (1.06 MB)]
  292.    - HPFS *HIGHLY* recommended (otherwise the length of usernames is restricted
  293.      to 8 characters (You may try FAT but it was not tested !)
  294.  
  295.  
  296.  
  297. ┌────────────────────────────────────────────────────────────────────────────┐
  298. │                                                                            │
  299. │ 4. Network structure                                                       │
  300. │                                                                            │
  301. └────────────────────────────────────────────────────────────────────────────┘
  302.  
  303.  
  304. ┌─────────────────┐
  305. │ remote "host1"  │                                                ---
  306. │ xxx.yyy.zzz.11  │-Modem--(Telephton network)--Modem1---.          |
  307. └─────────────────┘                                      |          |
  308.                                                          |          | Net xxx.yyy.zzz
  309. ┌─────────────────┐                                      |          |
  310. │ remote "host2"  │                                      |          |
  311. │ xxx.yyy.zzz.12  │-Modem--(Telephton network)--Modem2-. |          |
  312. └─────────────────┘                                    | |          |
  313.                                                        | '-┌─────────────────────┐
  314.                                                        '---│ "modem-host"        │
  315.                                                        .---│ xxx.yyy.zzz.10      │
  316.                                                        | .-│ Ethernet Address    │
  317. ┌─────────────────┐                                    | | │ 00:00:C0:04:F7:37   │
  318. │ remote "host3"  │                                    | | │                     │
  319. │ xxx.yyy.zzz.13  │-Modem--(Telephton network)--Modem3-' | └─────────────────────┘
  320. └─────────────────┘                                      |          |
  321.                                                          |          |
  322. ┌─────────────────┐                                      |     ┌─────────────────┐
  323. │ remote "host4"  │                                      |     │ default router  │
  324. │ xxx.yyy.zzz.14  │-Modem--(Telephton network)--Modem4---'     │ xxx.yyy.zzz.254 │
  325. └─────────────────┘                                            └─────────────────┘
  326.                                                                     |
  327.                                                                     '----<INTERNET>
  328.  
  329.  
  330.  
  331. ┌────────────────────────────────────────────────────────────────────────────┐
  332. │                                                                            │
  333. │ 5. Installation of Email Services                                          │
  334. │                                                                            │
  335. └────────────────────────────────────────────────────────────────────────────┘
  336.  
  337.    1. copy each file extracted from this archive to the location stated in
  338.       chapter 2. Add C:\USERCTRL to your PATH and LIBPATH in CONFIG.SYS.
  339.    2. add the following lines to CONFIG.SYS:
  340.         SET HOSTNAME=myHostname
  341.         SET MAILDIR=C:\MAIL
  342.       ETC and TMP are needed as well but should already be set by TCP/IP.
  343.       MAILDIR is the base directory under which the user mail directories will
  344.       be created, e.g. if you create the user "spiderman" the directory
  345.       C:\MAIL\SPIDERMAN will be created automatically.
  346.    3. To reduce system load I would suggest that you run the POP3 server
  347.       together with the INET server. By doing so the POP3 server will only
  348.       be started if actually someone wants POP3 services.
  349.       Therefore you should create or modify the file INETD.LST (C:\TCPIP\ETC)
  350.       as follows:
  351.          pop3 tcp c:\tcpip\bin\pop3d.exe
  352.       Make sure that the service POP3 is correct defined in SERVICES (C:\TCPIP\ETC).
  353.       There should be a line like this:
  354.          pop3            110/tcp         postoffice
  355.       Make sure your domain is specified correctly in RESOLV (C:\TCPIP\ETC).
  356.    4. Modify SENDMAIL.CF (editor must preserve TABS - use E.EXE/don't use EPM!!!).
  357.       Look for "MLocal" and modify as follows:
  358.          Mlocal, P=c:\tcpip\bin\mail.exe, F=lnsDFMP,  S=10, R=20, A=c:\mail $u $f
  359.       The Argument "A=c:\mail" specifies the base directory for mails (same
  360.       directory as MAILDIR in CONFIG.SYS)
  361.       In case you don't have set up sendmail already look for the "tags" (first two
  362.       letters of the following lines - e.g. "Dw")
  363.          Dwmodem-host
  364.          Cwmodem-host
  365.          DDmodem-domain.com
  366.          OAc:\tcpip\etc\aliases
  367.          OQc:\tcpip\etc\mqueue
  368.    5. Configure SETUP.CMD (C:\TCPIP\BIN).
  369.       Replace IP numbers like xxx.yyy.zzz.??? with your unique IP numbers.
  370.       Use the the sketch "Network structure" (chapter 3) for an overview.
  371.    6. Create users using ACCOUNTS.EXE ("accounts -a ...")
  372.    7. You can set limits for maximum disk space allocation by emails for all users
  373.       ("accounts -sd) and/or for specific users ("accounts -s").
  374.       You can set a maximum mail size above which mails will not be encrypted to
  375.       reduce system load ("accounts -e")
  376.    8. If you want to use the mail processor you must define it ("accounts -m")
  377.       The mail processor processes all mails addressed to "system@modem-host".
  378.       If you want to assign another username to the mail processor, you must
  379.       specify it in ALIASES (C:\TCPIP\ETC) like this:
  380.          mail-processor: system
  381.       This will result in all mails addressed to "mail-processor@modem-host" will
  382.       be processed by the mail processor.
  383.    9. Sending/Receiving emails should work at this state.
  384.       POP clients must specify "SMTP" (not POP3) for sending emails.
  385.  
  386.  
  387.  
  388. ┌────────────────────────────────────────────────────────────────────────────┐
  389. │                                                                            │
  390. │ 6. Installation of Modem Services                                          │
  391. │                                                                            │
  392. └────────────────────────────────────────────────────────────────────────────┘
  393.  
  394.  
  395.    1. Follow Step 1 of chapter 5 "Installation of Email Services"
  396.    2. Create the directory C:\USERCTRL\LOG
  397.    3. Configure TCPSTART.CMD (C:\TCPIP\BIN).
  398.       UnREM as many of the "call uc1", "call uc2" lines, as you have modems installed.
  399.    4. UnREM as many of the "arp -s ..." lines, as you have modems installed.
  400.       Replace "00:00:C0:04:F7:37" with the network address of the ethernet card of your
  401.       modem host.
  402.    5. Configure PPP1.CFG if you have 1 modem, PPP1.CFG+PPP2.CFG if you have 2 modems ...
  403.       Replace IP numbers like xxx.yyy.zzz.??? with your unique IP numbers.
  404.       Use the the sketch "Network structure" (chapter 3) for an overview.
  405.    6. Set "ModemMax" in USERCTRL.CMD (C:\USERCTRL) to the number of modems installed.
  406.    7. Modify your modem user login screen to your needs
  407.       Keep the "$" character in the last line which marks the end of the file.
  408.    8. Follow Steps 5 and 6 of chapter 5 "Installation of Email Services"
  409.  
  410.  
  411.  
  412. ┌────────────────────────────────────────────────────────────────────────────┐
  413. │                                                                            │
  414. │ 7. Conclusion                                                              │
  415. │                                                                            │
  416. └────────────────────────────────────────────────────────────────────────────┘
  417.  
  418. I hope I did not forget to include important information or files. If I did so
  419. I am sorry about it. Your emails should be answered within a day.
  420. If you have suggestions (especially for the mail processor) - tell me.
  421.  
  422. Axel Mueller
  423. amueller@stargate.rz.fh-offenburg.de
  424.  
  425. 04/14/96
  426.